# SSH remote terminal

***Copyright © Quectel Wireless Solutions Co., Ltd. 2026. All rights reserved.***

---

**SSH (Secure Shell Protocol)** is an encrypted network protocol used to securely access and manage computers remotely over insecure networks (such as the Internet). It protects communication security and prevents eavesdropping and tampering by establishing an **encrypted tunnel** between the client and the server.

```{note}
The device is connected to the network via wired or Wi-Fi connection. The Quectel Pi H1 Smart Single-Board Computer will automatically obtain an IP address via the DHCP protocol.
```

**The SSH server is disabled by default. It can be enabled using one of the following methods.**

# Operate on desktop of Smart Single-Board Computer

## Open terminal in system applications

```{image} images/image_MzBJbsIwvo61YDxlKc3cfnSAnzf.webp
:width: 1674px
:height: 939px
```

## Install ssh-server service

```bash
sudo apt install openssh-server
```

- If prompted as shown below, type "**Y+Enter**".

```{image} images/image_IFP5bGuRloxfWXxStpQcf504nLg.webp
:width: 957px
:height: 634px
```

- For any subsequent options, simply press `Enter`.

```{image} images/image_Ikh1bgeLootvPoxuLYScTCuynig.webp
:width: 727px
:height: 465px
```

## Start ssh-server service

```bash
# Enable auto-start
sudo systemctl enable ssh
# Start service
sudo systemctl start ssh
# Check service status
sudo systemctl status ssh
```

If the service status shows "active (running)", it indicates the service has started successfully. You can proceed to the next step.

```{image} images/image_Dybeba6Uiopxn7xcKAJcv0AFnje.webp
:width: 734px
:height: 483px
```

## Get IP address of Quectel Pi H1

Enter the `ip address` command in the terminal to view the **IP address** of Quectel Pi H1.

```{image} images/image_LOtPbRlWcoOXTGxFvZdcneyxnZf.webp
:width: 732px
:height: 480px
```

## **Configure SSH login**

Enter the following command in the Windows console. You need to enter "**Yes**" to confirm the connection during the connection process.

```bash
ssh <username>@<ip-address># Examplessh pi@192.168.2.xxx  
```

```{image} images/image_JbEKbrc4rox710xxjDhcYwaInoy.webp
:width: 977px
:height: 393px
```

# Operate on serial console

## Log in to serial console

Open PuTTY, configure USB serial port parameters, then click "**Open**".

```{image} images/image_EN4BbVV69oZbf0x34YycIWe5n4b.webp
:width: 445px
:height: 438px
```

## **Install ssh-server service**

```bash
sudo apt install openssh-server
```

- When prompted with "**Continue? [Y/n]**", press "**y+Enter**".

- For any subsequent options, simply press `Enter`.

## **Start ssh-server service**

```bash
# Enable auto-start
sudo systemctl enable ssh
# Start service
sudo systemctl start ssh
# Check service status
sudo systemctl status ssh
```

If the service status shows "active (running)", it indicates the service has started successfully. You can proceed to the next step.

```{image} images/image_EcGObh04boyCczxeNtgcJKPJnkN.webp
:width: 661px
:height: 418px
```

## **Get IP address of Quectel Pi H1**

Enter the `ip address` command in the serial console to view the **IP address** of Quectel Pi H1.

```{image} images/image_MpMgbGvMxoKaOUxnnXCcLv2lnuh.webp
:width: 661px
:height: 418px
```

## **Configure SSH login**

Reopen PuTTY, tick "**SSH**" and enter the **IP address** of Quectel Pi H1, then click "**Open**".

```{image} images/image_WXdGbK271o5nSLxpOxRcCB9lnVe.webp
:width: 441px
:height: 437px
```

For the username and password settings used during login, please refer to the [System login](<../../../Operating system/Debian/System login/System login.md>) chapter.